home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / standard / staux.z / staux
Encoding:
Text File  |  1998-10-30  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTAAAAUUUUXXXX((((3333XXXX))))                                                            SSSSTTTTAAAAUUUUXXXX((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      staux - routines that provide scalar interfaces to auxiliaries
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmmssss....hhhh>>>>
  13.  
  14.      lllloooonnnngggg sssstttt____aaaauuuuxxxxbbbbttttaaaadddddddd((((lllloooonnnngggg bbbbtttt))));;;;
  15.  
  16.      lllloooonnnngggg sssstttt____aaaauuuuxxxxbbbbttttssssiiiizzzzeeee((((lllloooonnnngggg iiiiaaaauuuuxxxx,,,, lllloooonnnngggg wwwwiiiiddddtttthhhh))));;;;
  17.  
  18.      lllloooonnnngggg sssstttt____aaaauuuuxxxxiiiissssyyyymmmmaaaadddddddd((((lllloooonnnngggg iiiissssyyyymmmm))));;;;
  19.  
  20.      lllloooonnnngggg sssstttt____aaaauuuuxxxxrrrrnnnnddddxxxxaaaadddddddd((((lllloooonnnngggg rrrrffffdddd,,,, lllloooonnnngggg iiiinnnnddddeeeexxxx))));;;;
  21.  
  22.      lllloooonnnngggg sssstttt____aaaauuuuxxxxrrrrnnnnddddxxxxaaaadddddddd((((lllloooonnnngggg iiiiddddnnnn))));;;;
  23.  
  24.      vvvvooooiiiidddd sssstttt____aaaaddddddddttttqqqq((((lllloooonnnngggg iiiiaaaauuuuxxxx,,,, lllloooonnnngggg ttttqqqq))));;;;
  25.  
  26.      lllloooonnnngggg sssstttt____ttttqqqqhhhhiiiigggghhhh____aaaauuuuxxxx((((lllloooonnnngggg iiiiaaaauuuuxxxx))));;;;
  27.  
  28.      vvvvooooiiiidddd sssstttt____sssshhhhiiiiffffttttttttqqqq((((iiiinnnntttt iiiiaaaauuuuxxxx,,,, iiiinnnntttt ttttqqqq))));;;;
  29.  
  30.      lllloooonnnngggg sssstttt____iiiiaaaauuuuxxxx____ccccooooppppyyyyttttyyyy((((lllloooonnnngggg iiiiffffdddd,,,, ppppSSSSYYYYMMMMRRRR ppppssssyyyymmmm))));;;;
  31.  
  32.      vvvvooooiiiidddd sssstttt____cccchhhhaaaannnnggggeeeeaaaauuuuxxxx((((lllloooonnnngggg iiiiaaaauuuuxxxx,,,, AAAAUUUUXXXXUUUU aaaauuuuxxxx))));;;;
  33.  
  34.      vvvvooooiiiidddd sssstttt____cccchhhhaaaannnnggggeeeeaaaauuuuxxxxrrrrnnnnddddxxxx((((lllloooonnnngggg iiiiaaaauuuuxxxx,,,, lllloooonnnngggg rrrrffffdddd,,,, lllloooonnnngggg iiiinnnnddddeeeexxxx))));;;;
  35.  
  36. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  37.      Auxiliary entries are unions with a fixed length of four bytes per entry.
  38.      Much information is packed within the auxiliaries. Rather than have the
  39.      compiler front-ends handle each type of auxiliary entry directly, the
  40.      following set of routines provide a high-level scalar interface to the
  41.      auxiliaries:
  42.  
  43.      _s_t__a_u_x_b_t_a_d_d
  44.           Adds a type information record (TIR) to the auxiliaries.  It sets
  45.           the basic type (bt) to the argument and all other fields to zero.
  46.           The index to this auxiliary entry is returned.
  47.  
  48.      _s_t__a_u_x_b_t_s_i_z_e
  49.           Sets the bit in the TIR, pointed to by the _i_a_u_x argument.  This
  50.           argument says the basic type is a bit field and adds an auxiliary
  51.           with its width in bits.
  52.  
  53.      _s_t__a_u_x_i_s_y_m_a_d_d
  54.           Adds an index into the symbol table (or any other scalar) to the
  55.           auxiliaries.  It sets the value to the argument that will occupy all
  56.           four bytes. The index to this auxiliary entry is returned.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSTTTTAAAAUUUUXXXX((((3333XXXX))))                                                            SSSSTTTTAAAAUUUUXXXX((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      _s_t__a_u_x_r_n_d_x_a_d_d
  75.           Adds a relative index, RNDXR, to the auxiliaries.  It sets the rfd
  76.           and index to their respective arguments.  The index to this
  77.           auxiliary entry is returned.
  78.  
  79.      _s_t__a_u_x_r_n_d_x_a_d_d__i_d_n
  80.           Works the same as _s_t__a_u_x_r_n_d_x_a_d_d except that RNDXR is referenced by
  81.           an index into the dense number table.
  82.  
  83.      _s_t__i_a_u_x__c_o_p_y_t_y
  84.           Copies the type from the specified file (ifd) for the specified
  85.           symbol into the auxiliary table for the current file.  It returns
  86.           the index to the new aux.
  87.  
  88.      _s_t__s_h_i_f_t_t_q
  89.           Shifts in the specified type qualifier, tq (see sym.h), into the
  90.           auxiliary entry TIR, which is specified by the `iaux' index into the
  91.           current file. The current type qualifiers shift up one tq so that
  92.           the first tq (tq0) is free for the new entry.
  93.  
  94.      _s_t__a_d_d_t_q
  95.           Adds a type qualifier in the highest or most significant non-tqNil
  96.           type qualifier.
  97.  
  98.      _s_t__t_q_h_i_g_h__i_a_u_x
  99.           Returns the most significant type qualifier given an index into the
  100.           files aux table.
  101.  
  102.      _s_t__c_h_a_n_g_e_a_u_x
  103.           Changes the iauxth aux in the current file's auxiliary table to aux.
  104.  
  105.      _s_t__c_h_a_n_g_e_a_u_x_r_n_d_x
  106.           Converts the relative index (RNDXR) auxiliary, which is specified by
  107.           iaux, to the specified arguments.
  108.  
  109.      The programs must be loaded with the object file access routine library
  110.      libmld.a.
  111.  
  112. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  113.      stfd(3x), syms(4).
  114.  
  115. BBBBUUUUGGGGSSSS
  116.      The interface will added to incrementally, as needed.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.